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1. Introduction 


The U.S. Army Research Laboratory (ARL) Dismounted Infantry Simulator (DISim) is a 
training system for military operations on urban terrain (/). One particular application of DISim 
is the real-time computation and display of an urban structure fractured by a munition (2) and 
subsequent distribution of resultant rubble (3). The DISim approximation is empirically based, 
taking into account only the geometry of the situation; but a physical solution is being considered 
when real-time display is not compromised. An example of its utility could be when a soldier 
affixes an explosive on a building and then detonates it for tactical entry to the building interior. 
Simulation of such a perforation is computed by the DISim Hole Library, which is written in the 
object-oriented language C++. The resultant geometry and corresponding attribute data for the 
effected structure(s) are placed in Synthetic Environment Data Representation and Interchange 
Specification (SEDRIS) transmittal(s); the C++ language bindings of the application 
programming interface (API) are used for transmittal generation. SEDRIS transmittal formatted 
(STF) data is then available to compliant read APIs on a network of computers. 


ARL recently decided to update DISim for the latest SEDRIS technology (from 3.0.3 to 3.1.1), 
after several suggestions from the SEDRIS mailing list. Many on that list, which is primarily 
monitored by SEDRIS associates, believe 3.1.1 is not only more stable but also offers a much 
more consistent interface. Their web site (4) provides both guidance and software to promote 
migration. This includes a Perl script for global string replacement with exact matching. There 
are restrictions, however, when running the name_change.pl script as documented by a 
README file at the same web site. Still our application had to be manually edited for full 3.1.1 
compliancy. 


It is our hope that this report will assist in 3.0.3 to 3.1.1 migration of SEDRIS applications. We 
only address the Data Representation Model and the API for interchange of the environmental 
data. Our application did not use the other components—namely, the Spatial Reference Model, 
the Environmental Data Coding Specification, and the STF. Those who are just learning 
SEDRIS may want to go directly to the 3.1.1 specification. 


2. Migration of STF_Fracture 


Appendix A depicts the format of an STF Fracture transmittal. The actual C++ class for the 
3.0.3 write API (Appendix B) has been modified for 3.1.1 transmittal generation (Appendix C). 
Both versions are included in the appendices for a line-by-line comparison. The overall design 
of the class has stayed the same, but the representation (member data) and the interface (member 


functions) had to be changed. Data types, class fields, and constants were either renamed or 
removed as necessary. 


The STF_ Fracture interface has been divided into three tables. Table 1 consists of methods for 
instantiating an STF_Fracture object, including the transmittal root and the following top-level 
objects: description, point of contact, access, data quality, keywords, absolute time point, 
citation, rocess, and transmittal summary. All text strings, which are simply defined as a 
sequence of ASCII characters, were updated as shown. Sometimes this was an entire class name 
(e.g., SE OBJECT renamed to SE Object), and other times only the field name had to be 
changed (e.g., string value renamed to characters). Table 2 lists string values that were changed 
when constructing containers of geometric and attribute data. Each geometric primitive, which 
is a triangle in our simulation environment, has a mapping function pointing to data in the image 
library. The addImage() method in Table 3 is needed for placing texture data in this library. 
Note that multiple occurrences of identical replacements are not repeated in successive tables. 
This was done to minimize entries in these three tables. 


Table 1. Transmittal root and top level objects of STF_Fracture. 


Method Name 3.0.3 String 3.1.1 String 

create() SE_CREATE SE_AC_ MODE CREATE 
SE_ SUCCESS SE_STAT_CODE SUCCESS 

createDescription() | SE OBJECT SE_Object 
SE_FIELDS SE Fields 
SE_TRANSMITTAL ROOT_TOKEN SE_ DRM CLS TRANSMITTAL ROOT 
string length length 
string value characters 
SE_SUCCESS SE_STAT_CODE SUCCESS 
SE_ DESCRIPTION TOKEN SE DRM CLS DESCRIPTION 
SE_ POINT OF CONTACT TOKEN SE DRM CLS POINT OF CONTACT 
SE_ACCESS_TOKEN SE_ DRM CLS ACCESS 
SE_ DATA QUALITY _ TOKEN SE DRM CLS DATA QUALITY 
SE_KEYWORDS_TOKEN SE_ DRM CLS KEYWORDS 
SE_ABSOLUTE_TIME POINT TOKEN SE DRM CLS ABSOLUTE_TIME POINT 
SE_CITATION TOKEN SE DRM CLS CITATION 
SE _PROCESS_TOKEN SE DRM CLS PROCESS 
SE_TRANSMITTAL SUMMARY TOKEN | SE DRM CLS TRANSMITTAL SUMMARY 


The approach taken was to examine the core header file sedris.h for actual changes to the API. 
Although this may not have been the most efficient approach for simple changes, it did result in a 
better understanding of the new definition. The alternative is using the previously mentioned 
script. 


The application programmer will probably have little difficulty in strict string replacement for a 
particular case. However, actual logic changes require a more thorough understanding of 
SEDRIS technology. In our particular application, there were two main areas of concern. First, 
it was determined that the SE AddToTransmittal() function had to be removed in 3.1.1. This 


Table 2. Changes to model library of STF_Fracture. 


Method Name 


3.0.3 String 


3.1.1 String 


createModelLib() 


SE_OBJECT 

SE_FIELDS 

SE MODEL LIBRARY TOKEN 

SE MODEL _ TOKEN 

string length 

string value 

SE GEOMETRY MODEL TOKEN 

SE_ UNION OF PRIMITIVE GEOMETRY TOKEN 


SE_Object 

SE Fields 

SE_DRM_ CLS MODEL LIBRARY 
SE_DRM_CLS MODEL 

length 
characters 

SE_DRM_CLS_ GEOMETRY MODEL 

SE DRM CLS UNION OF PRIMITIVE GEOMETRY 


addPolygons() 


SE_POLYGON_TOKEN 

SE IMAGE MAPPING FUNCTION TOKEN 
SE REPLACE IMAGE 

SE REPEAT IMAGE 

SE PLANAR IMAGE PROJECTION 
SE VERTEX TOKEN 

SE_LSR_ LOCATION 3D_ TOKEN 
LSR_Location_3D.x 

LSR_Location_3D.y 

LSR_Location_3D.z 

SE RGB COLOR TOKEN 

SE_ TEXTURE COORDINATE TOKEN 


SE_DRM CLS POLYGON 
SE_DRM_CLS_ IMAGE MAPPING FUNCTION 
SE_IMG MAPNG METH REPLACE 
SE_IMG_ WRAP _ REPEAT 

SE_IMG PROJ_TYP_PLANAR 
SE_DRM CLS VERTEX 

SE_DRM CLS _LSR_ LOCATION 3D 
LSR_Location_3D.coordinate.x 
LSR_Location_3D.coordinate.y 
LSR_Location_3D.coordinate.z 
SE_DRM_CLS\_RGB COLOUR 

SE_DRM CLS TEXTURE COORDINATE 


Table 3. Changes to image library of STF_Fracture. 


Method Name 3.0.3 String 3.1.1 String 
createlmageLib() SE_ FIELDS SE_Fields 
SE_IMAGE LIBRARY TOKEN SE_DRM_CLS_ IMAGE LIBRARY 
addImage() SE_OBJECT SE_Object 
SE_IMAGE TOKEN SE_DRM_CLS_IMAGE 
string length length 
string_value characters 


color_model 

SE_ RGB MODEL 

mip fields array 
SE_IMAGE MIP FIELDS 
SE_IMAGE_ SCAN RU 

SE_IMAGE SCAN Z NO Z 

SE_ UNSIGNED INTEGER 

SE IMAGE SIGNATURE LUMINANCE 
bits_of_first_color_coord 

bits_of second_color_coord 
bits_of_third_color_coord 
max_value_of first_color_coord 
max_value_of_second_color_coord 
max_value_of third _color_coord 

SE IMAGE SIGNATURE 123COLOR 


colour_model 
SE_CLR_MDL_ RGB 
mip_extents_array 

SE _Image_MIP_Extents 

SE_IMG SCAN_DIR_RIGHT_UP 
SE_IMG SCAN_DIR_Z NONE 
SE_IMG_COMP_TYP_UNSIGNED_ INTEGER 
SE_IMG SIG_LUMINANCE 
bits_of_colour_coordinate_1 
bits_of_colour_coordinate_2 
bits_of_colour_coordinate_3 
max_value_of_colour_coordinate_1 
max_value_of_colour_coordinate_2 
max_value_of_colour_coordinate_3 
SE_IMG SIG _123COLOUR 


impacted lines 56—59 of the original STF_Fracture.C (Appendix B). The operation is now 
absorbed when the object is created. 


Also, the 3.1.1 specification states that the implementation identifier argument of 

SE CreateObject() needs to be replaced by the SE Transmittal pointer. Secondly, two fields of 
the image mapping function were removed—the id and presentation_domain fields. SEDRIS 
3.1.1 guides state that this can be done safely. 


3. Conclusion and Future Efforts 


This report presented details for translating the STF_Fracture class of DISim from SEDRIS 3.0.3 
to a 3.1.1 implementation. The exact string replacements were given in the three tables. In 
addition, logic changes were identified, and appropriate methods were modified. 


We are now in the process of validating the generated transmittals for full compliancy. 
“Side-by-Side” (SbS) by Acusoft, Inc., will be used for graphical display of resultant transmittals 
(5). However, the latest version (SbS 2.5) must be used to view 3.1.1 transmittals. 


Future research will include the evaluation of existing technologies for synthetic environment 
representation in a Web environment. Possibilities are extensible markup language applications, 
such as extensible 3D (X3D), and the extensible modeling and simulation framework (XMSF), 
which allows for easy interaction over a highly distributed network. SEDRIS provides a 
thorough description of synthetic environments, but simulators on a network must have a read 
API to understand these transmittals. While XMSF may not be a replacement for SEDRIS, it 
could provide an extension for easier interoperation of simulation applications. 


4. 


References 


. Thomas, M. A. Dismounted Infantry Visualization Research: The Dismounted Infantry 


Simulation (DISim); ARL-TN-193; U.S. Army Research Laboratory: Aberdeen Proving 
Ground, MD, 2002. 


. Neiderer, A. M.; Thomas, M. A.; Pearson, R. 4 Fracturing of Polygonal Objects; 


ARL-TR-1649; U.S. Army Research Laboratory: Aberdeen Proving Ground, MD, 1998. 


. Neiderer, A. M.; Thomas, M. A.; Hansen, C. E. Distribution of Fragments Resulting From 


Polygonal Object Fracture; ARL-TN-182; U.S. Army Research Laboratory: Aberdeen 
Proving Ground, MD, 2001. 


. SEDRIS Home Page. http://www.sedris.org (accessed May 2003) 


. Neiderer, A. M. SEDRIS Transmittal Generation for a Dismounted Infantry Simulator; 


ARL-TR-2801; U.S. Army Research Laboratory: Aberdeen Proving Ground, MD, 2002. 


. Carswell, J.; Campos, J.; Cox, R. The SEDRIS Transmittal Format; Science Applications 


International Corporation: Orlando, FL, 1999. 


INTENTIONALLY LEFT BLANK. 


Appendix A. Tree Representation of STF_Fracture Transmittal 


The following diagram organizes a Synthetic Environment Data Representation and Interchange 
Specification (SEDRIS) transmittal in hierarchical format. A SEDRIS transmittal is generated 
for each munition/structure fracture in the Dismounted Infantry Simulator. 
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Appendix B. 3.0.3 STF Fracture Class 


The C++ class STF Fracture encapsulates both data and functions for a Synthetic Environment 
Data Representation and Interchange Specification 3.0.3 transmittal of a Dismounted Infantry 
Simulator fracture. The member data and method interfaces are given in the header file 

STF _Fracture.H; methods are subsequently defined in the source file STF _Fracture.C. Note that 
a default constructor and destructor are also defined in STF_Fracture.H. 


The following pages in this appendix appear in their original form, without editorial change. 
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Appendix C. 3.1.1 STF_Fracture Class 


The C++ class for Synthetic Environment Data Representation and Interchange Specification 
3.1.1 transmittal generation of urban structure fracture is now given. This class is similiar to that 
in Appendix B but differs due to 3.1.1 requirements. 


The following pages in this appendix appear in their original form, without editorial change. 
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